home *** CD-ROM | disk | FTP | other *** search
/ SGI Performance Co-Pilot 1.3 / SGI Performance Co-Pilot 1.3.iso / dist / dist6.4 / pcp.idb / usr / share / catman / u_man / cat1 / pmnsadd.z / pmnsadd
Text File  |  1997-04-03  |  4KB  |  132 lines
  1.  
  2.  
  3.  
  4. PPPPMMMMNNNNSSSSAAAADDDDDDDD((((1111))))                                                          PPPPMMMMNNNNSSSSAAAADDDDDDDD((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppmmmmnnnnssssaaaadddddddd - add new names to the Performance Co-Pilot PMNS
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ////uuuussssrrrr////ppppccccpppp////bbbbiiiinnnn////ppppmmmmnnnnssssaaaadddddddd [----dddd] [----nnnn _n_a_m_e_s_p_a_c_e] _f_i_l_e [ ... ]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      ppppmmmmnnnnssssaaaadddddddd adds subtree(s) of new names into a Performance Metrics Name
  16.      Space (PMNS), as used by the components of the Performance Co-Pilot
  17.      (PCP).
  18.  
  19.      Normally ppppmmmmnnnnssssaaaadddddddd operates on the default Performance Metrics Namespace
  20.      (PMNS), however if the ----nnnn option is specified an alternative namespace is
  21.      used from the file _n_a_m_e_s_p_a_c_e.
  22.  
  23.      The default PMNS is found in the file /_v_a_r/_p_c_p/_p_m_n_s/_r_o_o_t unless the
  24.      environment variable PPPPMMMMNNNNSSSS____DDDDEEEEFFFFAAAAUUUULLLLTTTT is set, in which case the value is
  25.      assumed to be the pathname to the file containing the default PMNS.
  26.  
  27.      The new names are specified in the _f_i_l_e, arguments and conform to the
  28.      syntax for PMNS specifications, see ppppmmmmnnnnssss(4).  There is one PMNS subtree
  29.      in each _f_i_l_e, and the base PMNS pathname to the inserted subtree is
  30.      identified by the first group named in each _f_i_l_e, e.g. if the
  31.      specifications begin
  32.                myagent.foo.stuff {
  33.                    mumble     123:45:1
  34.                    fumble     123:45:2
  35.                }
  36.      then the new names will be added into the PMNS at the non-leaf position
  37.      identified by myagent.foo.stuff, and following all other names with the
  38.      prefix myagent.foo.
  39.  
  40.      The new names must be contained within a single subtree of the namespace.
  41.      If disjoint subtrees need to be added, these must be packaged into
  42.      separate files and ppppmmmmnnnnssssaaaadddddddd used on each, one at a time.
  43.  
  44.      All of the files defining the PMNS must be located within the directory
  45.      that contains the root of the PMNS, this would typically be ////vvvvaaaarrrr////ppppccccpppp////ppppmmmmnnnnssss
  46.      for the default PMNS, and this would typically imply running ppppmmmmnnnnssssaaaadddddddd as
  47.      root.
  48.  
  49.      Provided some initial integrity checks are satisfied, ppppmmmmnnnnssssaaaadddddddd will update
  50.      the PMNS using ppppmmmmnnnnssssmmmmeeeerrrrggggeeee(1) - if this fails for any reason, the original
  51.      namespace remains unchanged.
  52.  
  53.      The ----dddd option allows the resultant PMNS to optionally contain duplicate
  54.      PMIDs with different names in the PMNS.  By default this condition is
  55.      considered an error.
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69. PPPPMMMMNNNNSSSSAAAADDDDDDDD((((1111))))                                                          PPPPMMMMNNNNSSSSAAAADDDDDDDD((((1111))))
  70.  
  71.  
  72.  
  73. FFFFIIIILLLLEEEESSSS
  74.      /_v_a_r/_p_c_p/_p_m_n_s/_r_o_o_t       the default PMNS, when then environment variable
  75.                               PPPPMMMMNNNNSSSS____DDDDEEEEFFFFAAAAUUUULLLLTTTT is unset
  76.  
  77. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  78.      ppppmmmmnnnnssssccccoooommmmpppp(1), ppppmmmmnnnnssssddddeeeellll(1), ppppmmmmnnnnssssmmmmeeeerrrrggggeeee(1) and ppppmmmmnnnnssss(4).
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.                                                                         PPPPaaaaggggeeee 2222
  129.  
  130.  
  131.  
  132.